home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / programm.ing / winlib.lzh / WINLIB / WINLIB.HLP < prev    next >
Encoding:
Text File  |  1994-08-13  |  11.9 KB  |  266 lines
  1.  
  2.  WinLIB PRO Demo
  3.  Version 0.63A dated 03/05/94
  4.  
  5.  By Ken Hollis and Karl Anders Øygard
  6.  Released by Bitgate Software (USA) and Clever Bits (Norway)
  7.  
  8.  This is uncompleted documentation.  If you want to fool around with the
  9.  source code, more power to 'ya.  I will not explain any routines that are
  10.  undocumented.  You must find them out for yourself.  Hey, it was FREE!
  11.  
  12.  (Check out the TEST.C file.  It tells you quite a lot about how to code
  13.   with the library.)
  14.  
  15.  -------------------------------------------------------------------------
  16.  
  17.  This demo may be freely copied and distributed as long as there is no fee
  18.  involved with such distribution.  This program is Public Domain, and must
  19.  be released as-is, with no modifications done to any part of the archive
  20.  or the program itself.
  21.  
  22.  -------------------------------------------------------------------------
  23.  
  24.  NOTICE TO BETATESTERS:
  25.  """"""""""""""""""""""
  26.  This is the newest release for you guys, and there are quite a number of
  27.  improvements to the library.  For one thing, we have added desktop rout-
  28.  ines (and have worked on them a bit), boxframes with new 3D colour
  29.  design (thanks to an idea by Dan Hollis, a friendly betatester), command
  30.  lines (like those in Windoze), Menu command separators (like those found
  31.  in Geneva, and Enhanced GEM), and menubars with side roots (which work
  32.  quite well).
  33.  
  34.  Although this version is slow for the text part of things, I have decided
  35.  to go ahead and release this version so you can see what I've done, and
  36.  how the program itself is coming along.  Since this is not an official
  37.  release of the demo program itself, please report any bug reports.  If
  38.  you see a bug report that is *NOT* in the incompatibilities section,
  39.  please report it, otherwise, don't.  I already know about it.
  40.  
  41.  -------------------------------------------------------------------------
  42.  
  43.  New additions to WinLIB PRO:
  44.  """"""""""""""""""""""""""""
  45.  Since WinLIB PRO was last released, it has grown in popularity.  There-
  46.  fore, we have decided to continue its growth to gain more interest.
  47.  
  48.  The following is a detailed list of the features that have been added
  49.  since its previous 0.62 release:
  50.  
  51.  o Desktop routines:  Now WinLIB PRO allows you to iconify windows, delete
  52.    them, use the clipboard, and remove icons all in an easy-to-use desktop
  53.    style environment.
  54.  
  55.  o Boxframes:  You may have noticed that alot of items could be boxed into
  56.    nice little categories of selections.  The previous version did not
  57.    have this look; it required two objects (a header and a box) to perform
  58.    this task.  It now requires only one item, and can be modified at ease.
  59.  
  60.  o Command lines:  You may have used Windows in the past.  If you have,
  61.    you can plainly see that at the bottom of the window in some programs,
  62.    there is a long line that displays information about an object that you
  63.    click on, or about a menu item that you click.  This is now a part of
  64.    WinLIB PRO's library.
  65.  
  66.  o Custom menu separators:  Now, WinLIB PRO allows you to create custom
  67.    menu separators inside menus.  This is a long bar (disabled, of course)
  68.    and is used to make the menus look nicer.
  69.  
  70.  o Menu bars with side roots:  Now you can design a menu bar like never
  71.    before with new customized side root menus!  These add a nice little
  72.    feature, giving you a longer menu under one SUBTOPIC.  All you have
  73.    to do is set the Extended Object Type to point to your popup dialog,
  74.    and viola!  It's easier to check than it looks!  Also includes special
  75.    utilities based on MultiTOS (menu_attach/detach)
  76.  
  77.  o New flying dialogs, thanks to Markus Gutschke.  Now, you can move
  78.    any dialog box (MODAL only) around the screen by clicking on its flying
  79.    dialog object.  Then, you can just move the dialog as you normally do,
  80.    and it redraws the dialog AS YOU MOVE IT.  Nice addition.
  81.  
  82.  -------------------------------------------------------------------------
  83.  
  84.  Using WinLIB PRO:
  85.  
  86.  When you first booted this program, you will notice the menu bar at the
  87.  top of the screen.
  88.  
  89.  Use your mouse, and go up to the "Desk" menu.  Select "About WinLIB PRO".
  90.  You will then see a nice little windowed dialog box that lets you see the
  91.  information about this demo.
  92.  
  93.  Hotkeys are accessable in this demo by using the ALT-key and the high-
  94.  lighted key.  If there is a dialog box without an editable object inside
  95.  it, you can simply press the key that is highlighted to access that
  96.  object.
  97.  
  98.  Next, use your mouse and go to the "Windows" menu.  Select "Window #1".
  99.  This is a timer window, and it demonstrates the usage of WinLIB PRO's
  100.  multitasking timer windows.
  101.  
  102.  Select "Dialog #1" and you will see the first dialog box for the demo.
  103.  This demonstrates the usage of selectable boxes (with "X"es), circle-
  104.  cell radio buttons, editable text fields in which the mouse can re-
  105.  position the cursor, and the boxframes.  Select "OK" to close this
  106.  window.
  107.  
  108.  Select "Dialog #2" and you will be presented with another example.  This
  109.  example shows the different 3D drawing methods of WinLIB PRO.  These are
  110.  identical to MultiTOS/GEM 4.04.
  111.  
  112.  Select "Dialog #3" and you will be able to select a dropdown menu bar
  113.  inside the dialog.  Select either the down arrow (Dropdown arrow) or
  114.  the "Popup menu" items inside the dialog box.  You will then see a nicely
  115.  assorted selection of popup menus.
  116.  
  117.  Select "Dialog #4" and you can use the redraw-as-you-drag sliders.  Also,
  118.  the two rows of four boxes at the bottom are for testing purposes, and do
  119.  not currently have any function.  They just show the drawing styles that
  120.  we have, and rooted objects.  Actually, this is for a sizing problem
  121.  we are trying to fix at the moment.
  122.  
  123.  -------------------------------------------------------------------------
  124.  
  125.  Incompatibilities as of this time:
  126.  """"""""""""""""""""""""""""""""""
  127.  As with any program that doesn't still have all of the bugs out, there
  128.  will be some incompatibilities.  These are, of course, being worked on,
  129.  and should be rid of by the next version:
  130.  
  131.  The MENU BAR doesn't work with MultiTOS at the moment.  This is because
  132.  WinLIB PRO uses a special menu routine to handle the side-rooted objects
  133.  for the menu bar.  This should be fixed in the next version, if not
  134.  sooner.  It will be placed in a window if we can't get this thing working
  135.  correctly to fit MultiTOS's specifications...  Sheez!
  136.  
  137.  We know the desktop doesn't work that great.  We are currently working
  138.  on fixing the problem.  The ghost rectangle leaves a hideous mark after
  139.  you select an icon with it drawn.  We are working on correcting the
  140.  problem at this time with Olaf Meisiek.
  141.  
  142.  Don't tell us how slow the text window routines are.  We'll just jump up
  143.  and down and have a fit on the spot and never forgive you.
  144.  
  145.  We know help files don't work smoothly.  Don't remind us.  We're working
  146.  with Dan Wilga to get the format for his help files so we can create our
  147.  own help file viewer, hopefully with icons, custom selection buttons
  148.  (with a slight appearance to that of GEM, but less sophisticated), and
  149.  full-color bitmaps inside the display, as well as size changing.  All of
  150.  this will be released at a later date.
  151.  
  152.  Report any incompatibilities to KEN HOLLIS and KEN HOLLIS ONLY, since he
  153.  is the main programmer.  I am not responsable for any damage that this
  154.  program does to your system, but since it does not save any data to your
  155.  hard drive or floppy disk drives, don't panic.  It should not harm any
  156.  running processes or manipulate any protected data.
  157.  
  158.  The menu bars are totally and completely incompatible with MultiTOS and
  159.  Geneva at the moment.  Remedies are being designed.
  160.  
  161.  -------------------------------------------------------------------------
  162.  
  163.  Bug fixes:
  164.  """"""""""
  165.  Menu bars have been fixed so that they now are almost bug free.  Instead
  166.  of using the AES Screen Buffer of the Window Manager, we reserve our own
  167.  memory on the side to do screen copies, making things much safer.
  168.  
  169.  We can now register desk accessory names, but they cannot be called yet.
  170.  
  171.  No more bugs should result from using the menu bars.
  172.  
  173.  Unfortunately, we still haven't been able to figure out how to CORRECTLY
  174.  call accessories.  I have made attempts (with The Accessor) and have hit
  175.  brick walls from not being able to get it right.  Apparently, GEM has a
  176.  mind of its own in loading accessories.  I still don't know if they do it
  177.  by loading in the first accessory file they see (in unsorted order) or if
  178.  they use a special technique.  I just don't understand it (yet).
  179.  
  180.  Since the menu bars won't let you access accessories the complex way, we
  181.  opted to have an internal menu that will let you select an accessory by
  182.  using the standard menu_bar, and not ours (yet).
  183.  
  184.  -------------------------------------------------------------------------
  185.  
  186.  Keyboard Equivalents:
  187.  
  188.  At any time, hit [CTRL-ALT] and the following keys for quick, and easy
  189.  equivalents:
  190.  
  191.  (BS - Backspace)
  192.  (SP - Space)
  193.  (KP - Keypad and key shown)
  194.  
  195.  Key:   Action:
  196.  """""  """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  197.  <BS>   Close all currently opened windows (except iconified windows)
  198.  <SP>   Redraw all currently opened windows
  199.  <KP*>  Iconify/Maximize the current window
  200.  <KP8>  Move text inside a window up (try it now!)
  201.  <KP2>  Move text inside a window down
  202.  ENTER  Redraw the current window
  203.  UP     Move text inside a window up
  204.  DOWN   Move text inside a window down
  205.  HELP   Call the hyper-text help screen (currently unavailable)
  206.  <ESC>  Close the current window
  207.  
  208.  (These are the 3D styles:)
  209.  F5     MultiTOS/GEM 4.04 look
  210.  F6     Olaf Meisiek's (Zoom! Color Icon Editor) 3D look
  211.  F7     Motif (X11R5) 3D look
  212.  F8     Dan Wilga's (Geneva) 3D look
  213.  F9     WinLIB PRO 3D look (currently unavailable, it's being designed!)
  214.  F10    No 3D (Standard, wimpy NON-3D look (standard to AES below 3.0))
  215.  
  216.  -------------------------------------------------------------------------
  217.  
  218.  Coming Later (MUCH later):
  219.  
  220.  o Color icons inside the desktop and dialog boxes
  221.  o WinLIB PRO 3D look
  222.  o Full Mag!x compatibility (if I can ever get my hands on Mag!x)
  223.  o Internal IGORView (our new help file viewer) for hyper-text files
  224.  o anything else we can think of!
  225.  
  226.  -------------------------------------------------------------------------
  227.  
  228.  Special thanks to:
  229.  """"""""""""""""""
  230.  - Christian Rountree for moral support on the ForemNET
  231.  - Peter Seitz for his great Application Library (APP_LIB)
  232.  - Olaf Meisiek for support, programming help, and some debugging
  233.  - Markus Gutschke for his flying dialog and screen copy routines, and
  234.    his object-oriented library
  235.  - Dan Wilga for helpful hints and tips here and there and for the help
  236.    with Pure C and Geneva programming tips
  237.  - Christian Grunenberg for letting me use various parts of Enhanced GEM
  238.    for reference (I still think WinLIB PRO is better, though, Criss!  ^_^)
  239.  - Eric Smith for the info on appl_search (for desk accessory stuff for
  240.    MultiTOS), and on other special routines used internally, especially
  241.    for tips on programming with MultiTOS
  242.  - Dan Hollis, Andy Smith, Christian Rountree, Michael Forget, and
  243.    Michael Robinson for timeless betatesting on their Atari STs and other
  244.    platforms by Atari...  You all made it possible!
  245.  - MEGA thanks to Dan Hollis for helping me figure out how to get the
  246.    desk accessory names.  Without him, the desk accessory calling would
  247.    never have been possible.
  248.  
  249.  -------------------------------------------------------------------------
  250.  
  251.  Any questions about this demo program, or any like it that we release?
  252.  If so, please contact us at:
  253.  
  254.  Ken Hollis
  255.    InterNET:  khollis@bitsink.gbdata.com
  256.  
  257.  Karl Øygard
  258.    InterNET:  karlo@ifi.uio.no
  259.  
  260.  If you are interested in become a betatester, or are reporting a bug,
  261.  please write to one of us, preferrably Ken Hollis.  Also, if you are
  262.  interested in joining the programming project, please write to Ken Hollis.
  263.  
  264.  Happy coding...
  265.  Ken Hollis and Karl Øygard
  266.